Release 10.1A: OpenEdge Development:
Progress Dynamics Getting Started

Using the Localization Manager to translate a window

The Progress Dynamics Localization Manager lets you translate all visual elements of your application screens (including application messages) into any number of languages. You can also use the Language facility to provide alternative texts for any purpose, such as specializing labels, prompts, and messages for different user organizations.

To define a new language:

Choose Tools Administration from the AppBuilder main window. The Administration window appears:



Choose Application Language Control. The Language Control dialog box appears:



Choose the Add button . The Language Maintenance dialog box appears.
Type FR for the Language Code and French for the Language Name. For clarity, use the standard, two-letter acronym for the language, followed by an optional two-letter variant acronym, such as EN-US for US English and EN-UK for British English, as shown:



Choose Save, then exit the Language Control and Language Maintenance dialog boxes.
Close the Administration window.

Now that you have a code in the Repository for French, you can store French translations. Then, you can create a French language user. In Progress Dynamics, you can translate all visual elements. However, depending on the type of element, you use different tools:

Widgets are translated screen by screen while they are running.
Menus are translated using the Menu and Toolbar Designer.
Messages are translated in the Message Control tool.

In this tutorial, you will translate widgets and menus. For translation of messages, see OpenEdge Development: Progress Dynamics Basic Development .

Translating widgets

You can translate any application screen while it is running.

To translate a screen into French:

Run oeMenuWin from the Dynamic Launcher. Remember to select all the toggle boxes.
Note: Remember to reconnect the DynSports database if you have restarted your session since last running the application.
Choose Order Entry Orders.
Double-click on an order to launch your Order and Lines Browse.
Select the Order Lines tab, as shown:



Choose File Translate. The Translate Window dialog box appears:



The Localization Manager builds the browse with all the translatable strings in the current window.

Select French in the Language combo box, and leave the Source Language on English. For a complete description of the options in the Translate Window, see OpenEdge Development: Progress Dynamics Basic Development .
Select the orderline_price fill-in widget.
Enter Prix ligne de commande: in the Translated label column.
Enter the widget label translations from the following table in the browse:

Widget type	Original label	Translated label
Fill-in	Discount:	Rabais ligne de commande:
Fill-in	Extended Price:	Prix prolonge ligne de commande:
Fill-in	Quantity:	Quantite:
Tab	Order	Ordre
Tab	Order Lines	Ligne de commandes

Choose OK, and close your application windows.

Translating menus

To translate a menu into French:

Choose Build Toolbar and Menu Designer in the AppBuilder main window.
Select the ds-general module.
Choose Item Categories DynSports Customers. The Customers details appear in the update frame, as shown:



Choose the Translate Menu Item button . The Menu Item Translation dialog box appears:



Select French in the To combo box.
Select Menu Item Label in the browser.
Type Clientes in the French column and press TAB.
Choose OK.
Add the translations from the following table:

Menu element	Translation
Item Categories DynSports Orders	Commandes
Item Categories SubMenu Order Entry	Saisie de commandes

Exit the Toolbar and Menu Designer.

Before you can see the effects of your translations, you must log on as a French user. So, the next step is to create a French user.